﻿namespace AT.IBMS.Framework.Controls
{

    /// <summary>
    /// 指定页索引框的显示方式，以便用户输入或从下拉框中选择需要跳转到的页索引。
    /// </summary>
    public enum ShowPageIndexBox : byte
    {
        
        /// <summary>
        /// 从不显示页索引输入文本框。
        /// </summary>
        Never,
        
        /// <summary>
        /// 自动，选择此项后可以用 <see cref="AspNetPager.ShowBoxThreshold" /> 可控制当总页数达到多少时自动显示页索引输入文本框。
        /// </summary>
        Auto,
        
        /// <summary>
        /// 总是显示页索引输入文本框。
        /// </summary>
        Always
    }

    /// <summary>
    /// 指定页索引框的显示类型，可以是允许用户手工输入的文本框和只能选择的下拉框。
    /// </summary>
    public enum PageIndexBoxType
    {
        
        /// <summary>
        /// 使用文本框由用户手工输入页索引。
        /// </summary>
        TextBox,
        
        /// <summary>
        /// 使用下拉框，列出所有页索引由用户选择。
        /// </summary>
        DropDownList
    }


    /// <summary>
    /// 指定当前页索引和总页数信息的显示方式。
    /// </summary>
    public enum ShowCustomInfoSection : byte
    {
        
        /// <summary>
        /// 不显示。
        /// </summary>
        Never,
        
        /// <summary>
        /// 显示在页导航元素之前。
        /// </summary>
        Left,
        
        /// <summary>
        /// 显示在页导航元素之后。
        /// </summary>
        Right
    }

    /// <summary>
    /// 指定页导航按钮的类型。
    /// </summary>
    public enum PagingButtonType : byte
    {
        
        /// <summary>
        /// 使用文字按钮。
        /// </summary>
        Text,
        
        /// <summary>
        /// 使用图片按钮。
        /// </summary>
        Image
    }


    /// <summary>
    /// 分页控件自定义信息区和分页导航区使用的布局方式。
    /// </summary>
    public enum LayoutType : byte
    {
        
        /// <summary>
        /// 使用表格（Table）布局方式。
        /// </summary>
        Table,
        
        /// <summary>
        /// 使用Div布局方式。
        /// </summary>
        Div
    }

    /// <summary>
    /// 指定当前页数字索引按钮在所有数字页索引按钮中的位置。
    /// </summary>
    public enum PagingButtonPosition : byte
    {
        
        /// <summary>
        /// 当前页数字索引总是显示在所有数字页索引的最前面。
        /// </summary>
        Beginning,
        
        /// <summary>
        /// 当前页数字索引总是显示在所有数字页索引的最后面。
        /// </summary>
        End,
        
        /// <summary>
        /// 当前页数字索引总是显示在所有数字页索引的中间。
        /// </summary>
        Center,
        
        /// <summary>
        /// 默认值，当前页索引位置固定不变。
        /// </summary>
        Fixed
    }

    /// <summary>
    /// 指定分页元素（数字页索引、上页、下页、首页和尾页）的布局方式。
    /// </summary>
    public enum PagingButtonLayoutType : byte
    {
        
        /// <summary>
        /// 将每个分页元素包含在&lt;li&gt;与&lt;/li&gt;之间。
        /// </summary>
        UnorderedList,
        
        /// <summary>
        /// 将每个分页元素包含在&lt;span&gt;与&lt;/span&gt;之间。
        /// </summary>
        Span,
        
        /// <summary>
        /// 不设置，使用默认布局。
        /// </summary>
        None
    }

    /// <summary>
    /// 指定导航元素的位置。
    /// </summary>
    public enum NavigationButtonPosition : byte
    {
        
        /// <summary>
        /// 首页、上页、下页和尾页四个导航按钮全部分布于分页导航元素左侧。
        /// </summary>
        Left,
        
        /// <summary>
        /// 首页、上页、下页和尾页四个导航按钮全部分布于分页导航元素右侧。
        /// </summary>
        Right,
        
        /// <summary>
        /// 默认值，首页、上页、下页和尾页四个导航按钮分布于分页导航元素两侧。
        /// </summary>
        BothSides
    }

}
